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ABOUT THIS CHAPTER 


This chapter describes the Start Manager, which coordinates the initialization 
and system startup procedures of the Macintosh SE and Macintosh II. 


Reader's guide: The Start Manager is operated entirely by the standard 
Macintosh operating system. The only time you might need 
to understand the Start Manager is if you were implementing 
a different operating system on the Macintosh. 
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INITIALIZATION 


When the Macintosh SE or Macintosh II are turned on or restarted, the Start 
Manager goes through the following initialization procedures (steps specific to 
the Macintosh II are noted as such): 


e 


A set of diagnostic routines test the critical hardware components 
(VIA1, VIA2, SCC, IWM, SCSI, and ASC); if the diagnostics succeed, the 
familiar startup tone is issued and the hardware components are 
initialized. 

Memory is tested in two stages, depending on whether the machine is 
being turned on or the system is being restarted. A complete test of 
RAM is done only when the system is first turned on; on a system restart, 
only a quick 1K RAM test is performed. 

The Start Manager determines which microprocessor is installed and the 
rate at which it's running. The global variable CPUFlag will contain 
the value 0, 1, or 2, indicating that the processor is an MC68000, 68010, 
or 68020 respectively. If the MC68020 is present, the instruction cache 
is enabled. Several global variables are initialized with timing 
information (see below for details). 

Global variables needed by the system and interrupt dispatch tables are 
initialized. 

On the Macintosh II, the system is put in 24-bit mode for compatibility 
with existing Macintosh software. (For information on how to convert to 
32-bit address mode, see the Operating System Utilities chapter.) 

A small system heap is created; this heap will grow in order to 
accommodate additional drivers. 

The ROM resources, Package Manager, and Time Manager are initialized. 

On the Macintosh II, the Slot Manager is initialized and the 
initialization code on the declaration ROM of each inserted card is 
executed. 

The Apple Desktop Bus Manager is initialized. 

On the Macintosh II, the Start Manager looks for a video card to use as 
the main video display. It first tries the device specified by the user 
via the Control Panel. If no device has been specified, or if the 
specified card isn't found, it looks for the first available video 
sResource. (SResources are described in the Slot Manager chapter. ) 
QuickDraw is initialized and the desktop is drawn. 

The SCSI Manager, Disk Manager, and Sound Manager are initialized. 

The cursor is made available. (If no video card was found, the global 
variable ScrnBase is set to 0.) 
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SYSTEM STARTUP 


After initialization has been completed, the Start Manager performs the 
following system startup procedures: 


¢ The drive number of the internal SCSI drive is obtained from parameter 
RAM. The Start Manager then pauses from 15 to 31 seconds to allow the 
device to power up. (The amount of time that the system waits can be 
obtained and changed with the GetTimeout and SetTimeout procedures, 
described below. ) 

¢ The Start Manager looks for an appropriate start device. It first 
checks the 3.5-inch drives, starting with the internal drive; if no 
disk is found, the device specified as the default start device by the 
user (via the Control Panel) is used. If no default is specified, or 
if the specified device is no longer connected, it checks for devices 
on the SCSI bus, beginning with the internal drive (the drive number of 
the internal drive is contained in parameter RAM). The remaining drives 
are then checked, beginning with drive 6 and ending with drive 0. For 
each device, the appropriate driver is read in and entered in the drive 
queue. 

« Once a start device has been selected, system startup information is 
read from the device. On the Macintosh II, a slot device may take 
over the system startup process instead of providing system startup 
information; for details, see the Device Manager chapter. 

« If the system startup information is dispatchable (version $44), the code 
is executed; otherwise, the information is read in. (The format of the 
system startup information is given below. ) 

e Using this information, the System file is used to initialize the 
Resource Manager, and the System Error Handler and Font Manager are then 
initialized. 

« The system startup screen, if present, is displayed (the name of the 
startup screen, typically "StartUpScreen", is contained in the system 
startup information). 

« The debugger, if present, is loaded (the name of the debugger, typically 
"MacsBug", is contained in the system startup information). 

¢ ROM patches are loaded from resources of type 'PTCH'. 

¢ If the machine uses the Apple Desktop Bus, all resources of type 'ADBS' 
are loaded and executed. 

e Tracking of mouse movement begins. 

¢ Drivers read in from slot devices are opened if the flag fOpenAtStart in 
the sRsrc_ Flags field of the device's sResource is set. This flag is 
discussed under "Installing a Driver at Startup" in the Driver Design 
chapter of "Designing Cards and Drivers for Macintosh II and Macintosh SE." 

e The RAM cache specified in the Control Panel is installed, and the 
application heap is initialized. 

e All 'INIT' resources are loaded and executed (see below for details). 

e The system heap size (determined by the system startup information) and 
default folder are set. 

e The startup application is launched; if this fails, the Finder is launched. 
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SPECIAL TOPICS 


This section gives additional information about various aspects of 
initialization and system startup. 


System Startup Information 


Each Macintosh-initialized volume must contain system startup information in 
logical blocks 0 and 1 (sometimes referred to as the "boot blocks"). This 
information consists of certain configurable system parameters, such as the 
capacity of the event queue, the initial size of the system heap, and the number 
of open files allowed. Figure 1 gives the format of the first 16 fields of this 
system startup information. 
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Figure 1- ystem Startup Information 
Figure 1-System Startup Information 


The System file contains standard values for these fields that are used in 
formatting a volume. (The values for certain fields, such as the number of file 
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control blocks and the system heap size, depend on the machine that's running 
and are computed at system startup time.) You should have no reason to access 
the information in these fields; they're shown only for your information. 


The system startup information ID is used to verify that the blocks contain 
system startup information. 


The version number distinguishes between different versions of system startup 
information. A version number of $44 means that the blocks contain executable 
code. The code typically directly follows the startup information, and the 

entry code for such code is stored just before the version number (at byte 2). 


Following the version number are a number of names that identify standard files 
used or executed during system startup. These names can be up to 15 characters 
long, and must be preceded by a length byte. 


‘INIT' Resource 31 


The 'INIT' 31 resource (introduced in the System Resource File chapter) has been 
modified to provide a way for 'INIT' resources to request space in the system 
heap zone. Whenever 'INIT' 31 opens your file of type 'INIT' or 'RDEV', it now 
looks for a resource of type 'sysz' with an ID = 0. The 'sysz' resource can be 
any size you like, as long as the first long word contains the number of bytes 
of system heap space needed by the 'INIT' resources in your 'RDEV' or 

‘INIT' file. '‘INIT' 31 calls the SetApplBase procedure as needed to meet the 
Space request. For each 'INIT' resource loaded from the 'RDEV' or 'INIT' file, 
'INIT' 31 guarantees at least 16K of contiguous space in the system heap. 


Although the System Resource File chapter discussed allocation of space from the 
address contained in the global variable BufPtr, programmers are encouraged to 
take advantage of the 'sysz' resource for the memory needs of their ‘INIT' 
resources. 


Timing Information 


At system startup, a number of global variables are initialized with timing 
information useful to assembly-language programmers: 


Variable Contents 
TimeDBRA The number of times the DBRA instruction can be 
executed per millisecond. 
TimeSCCDB The number of times the SCC can be accessed per millisecond. 
TimeSCSIDB The number of times the SCSI can be accessed per millisecond. 


Access of the SCC and SCSI chips consists of the following two instructions 
(where register AQ points at the base address of the respective chips): 


@l BIST #0, (AQ) 
DBRA DO,@1 
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START MANAGER ROUTINES 


The routines described below are used by the Start Manager for configuring the 
system startup process. Only a very few advanced programmers who wish to 
implement a different operating system on the Macintosh will ever need to use 
these routines. 


GetDefaultStartup, SetDefaultStartup, GetTimeout, and Set Timeout are 
implemented for both the Macintosh SE and the Macintosh II. GetVideoDefault, 
SetVideoDefault, GetOSDefault, and SetOSDefault are implemented only on the 
Macintosh II. 


Routine parameters for GetDefaultStartup, SetDefaultStartup, GetVideoDefault, 
SetVideoDefault, GetOSDefault, and SetOSDefault are passed and returned using 
parameter blocks. 


Assembly-language note: When you call GetDefaultStartup, SetDefaultStartup, 
GetVideoDefault, SetVideoDefault, GetOSDefault, and 
SetOSDefault, AO must point to a parameter block that 
will contain the parameters passed to, or returned 
by, the routine. 


The DefStartRec parameter block used by GetDefaultStartup and SetDefaultStartup 
has the following structure: 


TYPE DefStartType 
DefStartRec 


(slotDev,scsiDev) ; 
RECORD 
CASE DefStartType OF 
slotDev: 
sdExtDevID: SignedByte; {external device ID} 
sdPartition: SignedByte; {reserved} 


sdSlotNum: SignedByte; {slot number} 
sdSRsrcID: SignedByte; {SResourceID} 
scsiDev: 


sdReservedl: SignedByte; {reserved} 

sdReserved2: SignedByte; {reserved} 

sdRefNum: INTEGER {driver reference number} 
END; 


DefStartPtr = “DefStartRec 
The two variants of the StartDevPBRec correspond to two types of devices that 
can currently be connected. The slotDev variant contains information about slot 
devices, while the scsiDev variant describes a device connected through the SCSI 
port. 


PROCEDURE GetDefaultStartup (paramBlock: DefStartPtr); 


--> 0 sdExtDevID byte or --> 0 sdReservedl byte 
25> 1 sdPartition byte --> 1 sdReserved2 byte 
--> 2 sdSlotNum byte --> 2 sdRefNum word 
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--> 3 sdSRsrcID byte 


GetDefaultStartup returns information about the default startup device from 
parameter RAM. To determine which variant to use, you need to look at the 
sdRefNum field. If this field contains a negative number, it's the driver 
reference number for an SCSI device, which is all you need to know. 
(SDReservedl and sdReserved2 are reserved for future use.) 


If sdRefNum contains a positive number, you'll need to access the information in 
the slotDev variant. SDExtDevID is specified by a slot's driver; it identifies 
one of perhaps several devices that are connected through a single slot. 
SDStotNum is the slot number ($9 thru E) and sdSRsrcID is the sResource ID; see 
the Slot Manager chapter for details. 


PROCEDURE SetDefaultStartup (paramBlock: DefStartPtr); 


<-- 0 sdExtDevID byte or <-- 0 sdReservedl byte 
<-- 1 sdPartition byte <-- 1 sdReserved2 byte 
<-- 2 sdSlotNum byte <-- 2 sdRefNum word 
<-- 3 sdSRsrcID byte 


SetDefaultStartup specifies a device as the default startup device. For a slot 
device, sdExtDevID (specified by the slot's driver) identifies one of perhaps 
several devices that are connected through a single slot. SDSlotNum is the slot 
number ($9 thru E) and sdSRsrcID is the sResource ID; see the Slot Manager 
chapter for details. 


In the case of an SCSI device, sdRefNum contains the reference number; to 
specify no device as default (meaning that the first available device will be 
chosen at startup), pass 0 in sdRefNum. SDReservedl and sdReserved2 are 
reserved for future use and should be @Q. 


The GetVideoDefault and SetVideoDefault calls use the following parameter block 
to pass information about the default video device: 


TYPE DefVideoRec = RECORD 


sdSlot: SignedByte; {slot number} 
sdSResource: SignedByte; {sResource ID} 
END; 


DefVideoPtr = “DefVideoRec 

PROCEDURE GetVideoDefault (paramBlock: DefVideoPtr) ; 
Trap macro _GetVideoDefault 
Parameter block 

--> 0 sdSlot byte 

--> 1 sdSResource byte 
GetVideoDefault returns the slot number and sResourceID of the default video 
device. If sdSlot returns 0, there is no default video device and the first 
available video device will be chosen. 


PROCEDURE SetVideoDefault (paramBlock: DefVideoPtr) ; 
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Trap macro _SetVideoDefault 


Parameter block 
eae te) sdSlot byte 
Soe 1 sdSResource byte 


SetVideoDefault makes the device with the given slot number and sResourceID the 
default video device. 


The GetOSDefault and SetOSDefault calls use the following parameter block to pas 
information about the default operating system: 


TYPE DefOSRec = RECORD 
sdReserved: SignedByte; /{reserved--should be 0} 
sd0SType: SignedByte; {operating system type} 
END; 


DefOSPtr “DefOSRec 


PROCEDURE GetOSDefault (paramBlock: DefOSPtr); 
Trap macro _GetOSDefault 


Parameter block 
--> 0 sdReserved byte 
--> 1 sd0SType byte 


GetOSDefault returns a value in sdOSType identifying the operating system to be 
used at startup. The sdReserved parameter currently returns 0; it's reserved 
for future use. This call is generally used only with partitioned devices 
containing multiple operating systems; for more details, see the SCSI Manager 
chapter. 


PROCEDURE SetOSDefault (paramBlock: DefOSPtr); 
Trap macro _SetOSDefault 


Parameter block 
<-- 0 sdReserved byte 
<-- 1 sd0SType byte 


SetOSDefault specifies in sdOSType the operating system to be used at startup. 
The sdReserved parameter is reserved for future use and should be 0. This call 
is generally used only with partitioned devices containing multiple operating 
systems; for details, see the SCSI Manager chapter. 


PROCEDURE GetTimeout (VAR count: INTEGER); 


Trap macro _GetTimeout 
On exit DO: count (word) 


Note: The GetTimeout macro is actually not a trap, but expands to invoke 
the trap macro InternalWait with a routine selector of 0 pushed on 
the stack. 
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GetTimeout returns in count the number of seconds the system will wait for the 
internal hard disk to respond. A value of 0 indicates the default timeout of 15 
seconds. 


PROCEDURE SetTimeout (count: INTEGER); 


Trap macro _SetTimeout 
On entry DO: count (word) 


Note: The SetTimeout macro is actually not a trap, but expands to invoke 
the trap macro InternalWait with a routine selector of 1 pushed on 
the stack. 


SetTimeout lets you specify in count the number of seconds the system should 
wait for the internal hard disk to respond. The maximum value is 31 seconds; a 
value of 0 indicates the default timeout of 15 seconds. 
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SUMMARY OF THE 


START MANAGER 


Data Types 
TYPE 
DefStartType = (slotDev,scsiDev) ; 
DefStartPtr = “DefStartRec 
DefStartRec = RECORD 
CASE DefStartType OF 
slotDev: 
sdExtDevID: SignedByte; {external device ID} 
sdPartition: SignedByte; {reserved} 
sdSlotNum: SignedByte; {slot number} 
sdSRsrcID: SignedByte; {SResourceID} 
scsiDev: 
sdReservedl: SignedByte; {reserved} 
sdReserved2: SignedByte; {reserved} 
sdRefNum: INTEGER {driver reference number} 
END; 
DefVideoPtr = “DefVideoRec 
DefVideoRec = RECORD 
sdSlot: SignedByte; {slot number} 
sdSResource: SignedByte; {sResource ID} 
END; 
DefOSPtr = “DefOSRec 
DefOSRec = RECORD 
sdReserved: SignedByte; /{reserved--should be 0} 
sdO0SType: SignedByte; {operating system type} 
END; 
Routines 


PROCEDURE GetDefaultStartup (paramBlock: 


ay 0 
--> 1 
--> 2 
ie 3 


PROCEDURE SetDefaultStartup (paramBlock: 


<-- 0 
<-- 1 
<-- 2 
<-- 3 


) 
) 
) 
) 


) 
i) 
) 
) 


dExtDev1ID byte 
dPartition byte 
dStotNum byte 
dSRsrcID byte 


dExtDev1ID byte 
dPartition byte 
dStotNum byte 
dSRsrcID byte 


DefStartPtr) ; 

or aS sdReservedl byte 
--> sdReserved2 byte 
--> sdRefNum word 
DefStartPtr) ; 

or <-- sdReservedl byte 
<-- sdReserved2 byte 
<-- sdRefNum word 


PROCEDURE GetVideoDefault (paramBlock: DefVideoPtr) ; 
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--> 0 sdSlot byte 
--> 1 sdSResource byte 


PROCEDURE SetVideoDefault (paramBlock: DefVideoPtr) ; 


<-- 0 sdSlot byte 
<-- 1 sdSResource byte 


PROCEDURE GetOSDefault (paramBlock: DefOSPtr); 


--> 0 sdReserved byte 
--> 1 sd0SType byte 


PROCEDURE SetOSDefault (paramBlock: DefOSPtr); 


<-- 0 sdReserved byte 
<-- 1 sd0SType byte 


PROCEDURE GetTimeout (VAR count: INTEGER); 
PROCEDURE SetTimeout (count: INTEGER); 


Assembly-Language Information 


Structure of Default Startup Device Parameter Block (Slot) 


sdExtDevID External device ID (byte) 
sdPartition Reserved-—should be 0 (byte) 
sdSlotNum Slot number (byte) 
sdSRsrcID SResource ID (byte) 


Structure of Default Startup Device Parameter Block (SCSI) 
sdReserved1 Reserved—should be 0 (byte) 

sdReserved2 Reserved—should be 0 (byte 

sdRefNum Driver reference number (word) 


Structure of Default Video Device Parameter Block 


sdSlot Slot number (byte) 
sdSResource SResource ID (byte) 


Structure of Default OS Parameter Block 


sdReserved Reserved—should be 0 (byte) 

sd0SType Operating system type (byte) 

Routines 

Trap macro On entry On Exit 
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_GetVideoDefault AQ: ptr to param block AQ: ptr to param block 
SetVideoDefault AQ: ptr to param block AQ: ptr to param block 


_GetOSDefault AQ: ptr to param block AQ: ptr to param block 
_SetOSDefault AQ: ptr to param block AQ: ptr to param block 
_GetTimeout DO: count (word) 
_SetTimeout DO: count (word) 


Note: The GetTimeout and SetTimeout macros expand to invoke the trap macro 
_InternalWait with routine selectors of 0 and 1 respectively pushed 
on the stack.) 


Variables 
CPUF lag Microprocessor in use (word) 
TimeDBRA Number of times the DBRA instruction can be executed 
per millisecond (word) 
TimeSCCDB Number of times the SCC can be accessed per millisecond (word) 
TimeSCSIDB Number of times the SCSI can be accessed per millisecond (word) 
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Further Reference: 


Technical Note #14, The INIT 31 Mechanism 
Technical Note #110, MPW: Writing Standalone Code 
"Macintosh Family Hardware Reference" 


END OF DOCUMENT 
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